Deletes a keychain item from the default keychain.

OSStatus KCDeleteItem (
    KCItemRef item
);

item

A reference to the keychain item you wish to delete. If you pass an item that has not been previously added to the keychain, KCAddItem does nothing and returns noErr.

function result

A result code. The result code errKCNoDefaultKeychain indicates that no default keychain could be found. The result code errKCInvalidItemRef indicates that the specified keychain item reference was invalid.

DISCUSSION

You can use the KCDeleteItem function to delete a keychain item from the permanent data store of the default keychain. KCDeleteItem may display the Unlock Keychain dialog box if the keychain containing the item is currently locked.

SPECIAL CONSIDERATIONS

KCDeleteItem does not dispose the memory occupied by the item reference. To do so, call the function KCReleaseItem when you are finished with an item.

VERSION NOTES

Available beginning with Keychain Manager 1.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 1.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)